Alqor — Bölmə 7: Xəta İdarəetməsi#

cəhd et
    <gövdə>
[tut [(<ad>: <XətaTipi>)]
    <gövdə>]...
[nəhayət
    <gövdə>]
son

cəhd et
    dəyişən n = tamƏt(oxu())
    yaz("Ədəd: {n}")
tut (x: ÇevrilməXətası)
    yaz("Bu ədəd deyil: {x.mesaj}")
son

cəhd et
    dəyişən m = fayl.oxu("verilən.txt")
    dəyişən v = json.oxu(m)
    emal(v)
tut (x: FaylTapılmadıXətası)
    yaz("Fayl yoxdur: {x.yol}")
tut (x: JSONXətası)
    yaz("Format pozulub, sətir {x.sətir}")
tut (x: Xəta)
    yaz("Naməlum xəta: {x.mesaj}")
nəhayət
    yaz("Bu blok həmişə işləyir")
son

cəhd et
    riskli()
tut (x: ŞəbəkəXətası | VaxtBitdiXətası)
    yaz("Bağlantı problemi")
son

cəhd et
    sorğu()
tut (x: HTTPXətası) əgər x.kod == 404
    yaz("Tapılmadı")
tut (x: HTTPXətası) əgər x.kod >= 500
    yaz("Server xətası")
tut (x: HTTPXətası)
    yaz("Digər HTTP xətası: {x.kod}")
son

cəhd et
    riskli()
tut
    yaz("Nəsə alınmadı")
son

dəyişən n = cəhd et
    ver tamƏt(giriş)
tut
    ver 0
son

at Xəta("Nəsə səhv getdi")
at ArqumentXətası("Yaş mənfi ola bilməz: {yaş}")
at ŞəbəkəXətası("Bağlantı kəsildi", kod: 503)

// Tutulmuş xətanı yenidən atmaq
cəhd et
    riskli()
tut (x: Xəta)
    jurnal.xəta(x)
    at                      // eyni xətanı yenidən at
son

// Səbəb zənciri ilə
cəhd et
    aşağıSəviyyə()
tut (x: Xəta)
    at VerilənlərXətası("Verilən yüklənmədi", səbəb: x)
son

Atılan
├── Xəta                          (bərpa oluna bilən)
│   ├── ArqumentXətası
│   │   ├── TipXətası
│   │   ├── DəyərXətası
│   │   └── DiapazonXətası
│   ├── ÇevrilməXətası
│   ├── RiyaziXəta
│   │   ├── BölməXətası
│   │   ├── DaşmaXətası
│   │   └── DəqiqlikXətası
│   ├── KolleksiyaXətası
│   │   ├── İndeksXətası
│   │   ├── AçarXətası
│   │   └── BoşKolleksiyaXətası
│   ├── GirişÇıxışXətası
│   │   ├── FaylTapılmadıXətası
│   │   ├── İcazəXətası
│   │   ├── DiskDoluXətası
│   │   └── FaylMəşğulXətası
│   ├── ŞəbəkəXətası
│   │   ├── BağlantıXətası
│   │   ├── VaxtBitdiXətası
│   │   ├── DNSXətası
│   │   └── HTTPXətası
│   ├── FormatXətası
│   │   ├── JSONXətası
│   │   ├── XMLXətası
│   │   └── KodlaşdırmaXətası
│   ├── VerilənlərBazasıXətası
│   │   ├── SorğuXətası
│   │   ├── ƏlaqəXətası
│   │   └── TranzaksiyaXətası
│   ├── BoşDəyərXətası
│   ├── VaxtXətası
│   └── İcazəsizXəta
│
└── KritikXəta                    (bərpa oluna bilməz, tutulmamalıdır)
    ├── YaddaşBitdiXətası
    ├── StekDaşmaXətası
    ├── İddiaXətası
    └── DaxiliXəta

sinif ÖdənişXətası miras Xəta
    xassə məbləğ: onluq
    xassə kart: mətn

    qurucu(mesaj: mətn, məbləğ: onluq, kart: mətn)
        üst(mesaj)
        özü.məbləğ = məbləğ
        özü.kart = kart
    son

    əvəz et metod mətnƏt() -> mətn
        qaytar "Ödəniş alınmadı: {özü.mesaj} ({özü.məbləğ} AZN)"
    son
son

at ÖdənişXətası("Balans kifayət etmir", 150.0, "****1234")

gətir nəticə

funksiya böl(a: tam, b: tam) -> Nəticə[onluq, mətn]
    əgər b == 0 onda
        qaytar Xəta("Sıfıra bölmə")
    son
    qaytar Uğur(a / b)
son

// İstifadə 1 — seç
seç böl(10, 2)
    hal Uğur(d) → yaz("Nəticə: {d}")
    hal Xəta(m) → yaz("Xəta: {m}")
son

// İstifadə 2 — metodlar
dəyişən n = böl(10, 0)
yaz(n.uğurludur())              // yanlış
yaz(n.dəyərVəYa(0.0))           // 0.0
yaz(n.çevir((x) => x * 2))      // Xəta saxlanılır

// İstifadə 3 — `?` yayma operatoru
funksiya hesabla() -> Nəticə[onluq, mətn]
    dəyişən a = böl(10, 2)?      // Xəta olsa dərhal qaytarır
    dəyişən b = böl(a, 5)?
    qaytar Uğur(a + b)
son

// İstisnaya çevirmək
dəyişən d = böl(10, 0).aç()     // Xəta olsa `at` edir

funksiya tap(id: tam) -> İstifadəçi?
    ...
son

dəyişən i = tap(5)
əgər i boş deyil onda
    yaz(i.ad)
son

// Zəncir
yaz(tap(5)?.ünvan?.şəhər ?? "naməlum")

funksiya emal()
    dəyişən f = fayl.aç("a.txt")
    gecikdir f.bağla()                // mütləq icra olunur

    dəyişən b = verilənlər.bağlan()
    gecikdir b.bağla()                // tərs sırada: əvvəl b, sonra f

    cəhd et
        işlə(f, b)
    tut (x: Xəta)
        jurnal.xəta(x)
    son
son

istifadə f = fayl.aç("a.txt")
    yaz(f.oxu())
son                                   // f.bağla() avtomatik

istifadə f = fayl.aç("a.txt"), b = verilənlər.bağlan()
    ...
son

interfeys Bağlanıla_bilən
    metod bağla()
son

// Bərpa olunmayan vəziyyət
panika("Bu heç vaxt baş verməməlidir")

// Üst səviyyədə panikanı tutmaq (yalnız server/xidmət üçün)
bərpa
    riskliModul.işlət()
tut (p: Panika)
    jurnal.kritik("Panika: {p.mesaj}")
    yenidənBaşlat()
son

gətir jurnal

jurnal.səviyyə("debaq")          // debaq | info | xəbərdarlıq | xəta | kritik

jurnal.debaq("Dəyişən x = {x}")
jurnal.info("Server başladı")
jurnal.xəbərdarlıq("Yaddaş 80% dolub")
jurnal.xəta("Sorğu alınmadı", xəta: x)
jurnal.kritik("Verilənlər bazası əlçatmazdır")

// Fayla yazmaq
jurnal.fayl("/var/log/proqram.log")
jurnal.format("json")             // mətn | json | rəngli

✖ Tutulmamış xəta: FaylTapılmadıXətası
  Mesaj: "verilən.txt" faylı tapılmadı
  Yol:   /home/vuqar/layihe/verilən.txt

  Çağırış yığını:
    1. fayl.oxu(yol: mətn)              fayl.alq:142:9
    2. konfiqYüklə()                     konfiq.alq:18:21
    3. başlat()                          əsas.alq:7:5
    4. əsas()                            əsas.alq:3:1

  Səbəb: GirişÇıxışXətası — ENOENT (2)

  = kömək: faylın mövcudluğunu `fayl.vardır(yol)` ilə yoxlayın
  = sənəd: vuqar.pro/alqor/xeta/FaylTapılmadıXətası